home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / kng110.zip / SYSOP.KNG < prev    next >
Text File  |  1992-07-10  |  20KB  |  568 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                      KINGDOM
  21.                                   Version 1.00
  22.                             ** SYSOP Documentation **
  23.  
  24.                              Last Revision: 03/28/92
  25.  
  26.  
  27.                     Find support at for Caliber Software at:
  28.                               ProTem University BBS
  29.                                  (816) 429-1751
  30.                                 1:280/71 Fido Net
  31.                                75:7816/2 Door Net
  32.  
  33.  
  34.                            Contact me at: Caliber Software
  35.                                           C/O Ben Vegiard
  36.                                           1406 Kingswood
  37.                                           Fulton, MO 65251
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.         KINGDOM Sysop Documentation                           Ben Vegiard
  66.  
  67.  
  68.                                ╔════════════════╗
  69.                             ▓░▒║  INTRODUCTION  ║▒░▓
  70.                                ╚════════════════╝
  71.  
  72.          Kingdom is an old classic computer game brought to the world of
  73.          BBS door games.  It is a simple economics game where the user
  74.          rules a Kingdom for 50 years.  The player starts off with a small
  75.          amount of bushels (the food and money of the game), land to plant,
  76.          and peasant workers and must manipulate these variables to produce
  77.          and thriving Kingdom.  It is actually quite a simple game, but I
  78.          have added a few new twists and some nice graphics to make things
  79.          more interesting.
  80.  
  81.          As with all Caliber Software, Kingdom is simple to configure, run,
  82.          and maintain.  It uses up a minimum of hard drive space, and is
  83.          configurable to your tastes.
  84.  
  85.  
  86.                             ╔══════════════════════╗
  87.                          ▓░▒║  WHAT YOU WILL NEED  ║▒░▓
  88.                             ╚══════════════════════╝
  89.  
  90.          - IBM Compatible Personal Computer
  91.          - Approximately 35k Free RAM space
  92.          - BBS Software that supports either DORINFOx.DEF or DOOR.SYS.
  93.          - Some systems may require the use of a fossil driver such as X00
  94.            or BNU.
  95.  
  96.                          ╔═════════════════════════════╗
  97.                       ▓░▒║  FILES INCLUDED IN ARCHIVE  ║▒░▓
  98.                          ╚═════════════════════════════╝
  99.  
  100.          READ.ME      : 'Where to go first' file.
  101.          KINGOM.EXE   : Main executable file.
  102.          KINGDOM.CFG  : Configuration file.
  103.          INSTRUCT.KNG : Player instruction.
  104.          WIZARD.KNG   : Random Wizard announcements.
  105.          SYSOP.KNG    : This documentation
  106.          UPGRADE.KNG  : Instructions on upgrading from Beta Version 1.0
  107.          KING_UP.EXE  : Upgrades data files from version 1.0 Beta
  108.                         format to the current 1.0 (proper) format.
  109.          FORM.KNG     : Ready to mail Registration form.
  110.          CALIBER.TXT  : Listing of all available software from Caliber.
  111.  
  112.  
  113.                        ╔═════════════════════════════════╗
  114.                     ▓░▒║  FILES CREATED BY THIS PROGRAM  ║▒░▓
  115.                        ╚═════════════════════════════════╝
  116.  
  117.          SCOREDTA.KNG : Contains score information
  118.          LOCK.KNG     : This file lets kingdom know not to access data
  119.                         files while other nodes are using them.
  120.          Bulletins    : Kingdom creates ANSI and ASCII player bulletins.
  121.  
  122.  
  123.  
  124.          Page 2
  125.  
  126.  
  127.  
  128.         KINGDOM Sysop Documentation                           Ben Vegiard
  129.  
  130.  
  131.                                ╔═════════════════╗
  132.                             ▓░▒║  CONFIGURATION  ║▒░▓
  133.                                ╚═════════════════╝
  134.  
  135.          It's simple.  Type up a file using you text editor by the name
  136.          KINGDOM.CFG (or just alter the one that is included) and put in
  137.          the following parameters:
  138.  
  139.          Line 1: BBS NAME
  140.          Line 2: Path and name to ASCII winners listing.  For example:
  141.                  C:\BBS\BULLETIN\BULL14.TXT
  142.                  Be sure to put the filename and DO NOT LEAVE THIS LINE
  143.                  BLANK!
  144.                  If no path is specified then OBSESSION will write the
  145.                  bulletin in the same directory where the executable file
  146.                  resides.
  147.          Line 3: Path and name to ANSI winners listing.  For example:
  148.                  C:\BBS\BULLETIN\BULL14.ASC
  149.                  Be sure to put the filename and DO NOT LEAVE THIS LINE
  150.                  BLANK!
  151.                  If no path is specified then OBSESSION will write the
  152.                  bulletin in the same directory where the executable file
  153.                  resides.
  154.          Line 4: Path and name of desired door drop file.  For example:
  155.                  C:\BBS\DORINFO1.DEF, or C:\DOORS\KINGDOM\DORINFO2.DEF, or
  156.                  C:\BBS\NODE1\DOOR.SYS.  KINGDOM supports DORINFOx.DEF and
  157.                  DOOR.SYS.
  158.          Line 5: Level of difficulty.  1 = Easy, 2 = Medeum, 3 = Hard!
  159.                  0 = Let the player choose their own level
  160.                  See OTHER NOTES for more details.
  161.          Line 6: Number of minutes the player is allowed to play in one
  162.                  day.  If this is set to 0 then the player is allowed as
  163.                  much time as he/she has left on the BBS
  164.          Line 7: Use fossil driver.  Place a 'Y' here if you wish to have
  165.                  fossil routines activated.  Most systems will work without
  166.                  the fossil, but some seem to require the aid of a fossil
  167.                  driver such as X00 or BNU.
  168.          Line 8: Registration Number.
  169.                  If you register your copy of KINGDOM is registered, place
  170.                  your registration number here EXACTLY as it appears.
  171.                  If you have not registered KINGDOM (yet (G)) place a 0
  172.                  here.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.          Page 3
  188.  
  189.  
  190.  
  191.         KINGDOM Sysop Documentation                           Ben Vegiard
  192.  
  193.  
  194.                            ╔════════════════════════╗
  195.                         ▓░▒║  LET'S RUN THIS PUPPY  ║▒░▓
  196.                            ╚════════════════════════╝
  197.  
  198.          Simply set up you batch file along these lines:
  199.  
  200.          CD \BBS\DOORS\KINGDOM
  201.          KINGDOM KINGDOM.CFG
  202.          CD \BBS
  203.          BOARD
  204.  
  205.          and that should do it.  There are no mandatory command line
  206.          parameters to mess with.  Just be sure your config file is in the
  207.          same directory as your executable file or you supply a path on the
  208.          command line.
  209.  
  210.          Alternate configurations can be called from the command line.  For
  211.          example, to use a config file by the name KNGNODE2.CFG call
  212.          KINGDOM by the statement KINGDOM KNGNODE2.CFG
  213.  
  214.          Kingdom may also be called from DOS.  Use KINGDOM KINGDOM.CFG /L
  215.          to run from a DOS prompt, or to force local mode from a batch
  216.          file.  See COMMAND LINE SWITCHES below for details.
  217.  
  218.          NOTE: If no configuration file is specified then Kingdom will
  219.          default to KINGDOM.CFG as the config file name.
  220.  
  221.          If you experience difficulty with the carrier routines (won't
  222.          send data to the remote user, won't read remote users keys, etc)
  223.          and you are not activating the fossil routines (in the config file
  224.          or by using the /F command line switch), I would suggest you do
  225.          so.  To take advantages of these routines you must have a fossil
  226.          driver such as X00 or BNU installed.  If you have installed and
  227.          activated these routines are still having problems then please
  228.          contact me!
  229.  
  230.  
  231.                              ╔════════════════════╗
  232.                           ▓░▒║  MULTI-NODE USAGE  ║▒░▓
  233.                              ╚════════════════════╝
  234.  
  235.          KINGDOM is multi-node aware in the sense that it creates a
  236.          temperary file (LOCK.KNG) everytime it writes to the disk.  Before
  237.          anything is written to the disk KINGDOM checks for this file.  If
  238.          the file is present then it waits a until the KINGDOM game running
  239.          on another node finishes up what it is doing.  If it has to wait
  240.          too long the game aborts, assuming the game on the other node has
  241.          crashed for whatever reason.
  242.  
  243.          This little trick helps to avoid file sharing conflicts and allows
  244.          two games to run simultaneously on 2 different nodes in peaceful
  245.          harmony.
  246.  
  247.  
  248.  
  249.  
  250.          Page 4
  251.  
  252.  
  253.  
  254.         KINGDOM Sysop Documentation                           Ben Vegiard
  255.  
  256.  
  257.                            ╔═════════════════════════╗
  258.                         ▓░▒║  COMMAND LINE SWITCHES  ║▒░▓
  259.                            ╚═════════════════════════╝
  260.  
  261.          A number of command line switches are supported by Kingdom.  Below
  262.          are the details of each switch.  All switches must have a
  263.          backslash (/) or a dash (-) in front of them.  For example:
  264.          KINGDOM KINGDOM.CFG  /L  would  run  kingdom  in  local  mode  (as
  265.          described below) Command line switches ARE NOT case sensitive.
  266.  
  267.          F  Force use of Fossil driver.  Whether or not you have your
  268.             fossil driver set in your config, this switch will force
  269.             KINGDOM to use the fossil routines.
  270.  
  271.          H  (or ?) displays a short help screen with all command line
  272.             options and brief descriptions.
  273.  
  274.          L  Local mode.  Using this switch forces KINGDOM will ignore
  275.             sending or receiving characters from the comport.  When called
  276.             in this manner KINGDOM will not need the use of door files
  277.             (DOOR.SYS, etc) but DOES need a config file setting.  The
  278.             program will prompt you for your name and whether you want
  279.             graphics or not, all other settings (such as time left, etc)
  280.             will default to internal settings.
  281.  
  282.          NB No Status Bar.  This switch will tell KINGDOM to default to
  283.             having the status bar turned off upon log-in.  This switch is
  284.             useful for getting a better feeling of what the user sees
  285.             without the 2 line status bar at the bottom, or in conjunction
  286.             with the NS switch will complete clear the screen.
  287.  
  288.          NS No Snoop.  This switch will turn the snoop feature off (blank
  289.             the screen while the user is in the door so you don't see what
  290.             the user is up to.)
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.          Page 5
  314.  
  315.  
  316.  
  317.         KINGDOM Sysop Documentation                           Ben Vegiard
  318.  
  319.  
  320.                                 ╔══════════════╗
  321.                              ▓░▒║  SYSOP KEYS  ║▒░▓
  322.                                 ╚══════════════╝
  323.  
  324.          Various key combinations have been included in this program.
  325.          Following is a brief description of what they are and what they
  326.          do.
  327.  
  328.          ALT-F1: Display help.  This will give a summary of the available
  329.          SYSOP keys along the bottom of the status bar.  As soon as the
  330.          next minute rolls around the normal status bar will appear.
  331.  
  332.          ALT-B : Toggle Status Bar ON/OFF.  Using this function will turn
  333.          the status bar ON/OFF.  This comes in handy if you wish to have
  334.          more of an idea what the user would be seeing (without the 2 line
  335.          status bar at the bottom of the screen)  Used in conjunction with
  336.          ALT-S it can be used to completely blank a screen.
  337.  
  338.          ALT-C : Chat Mode.  This key combination toggles chat mode.  When
  339.          chat is entered the screen is quickly memorized and re-drawn when
  340.          chat is exited.  This memorization only occurs if the user has
  341.          ANSI graphics enabled.  The re-draw feature helps the user to pick
  342.          back up where they were before the chat.  Time IS lost during
  343.          chat.  Use ALT-C again to exit chat mode.
  344.  
  345.          ALT-D : DROP TO DOS.  This function allows the SYSOP to drop to
  346.          DOS to do whatever.  The user will see nothing, and cannot
  347.          activate this function so the door is 'hack proof'  Be aware that
  348.          this program does not perform a memory swap before dropping, so a
  349.          minimum amount of memory is required.  This amount varies from
  350.          system to system, largely due to the type of software being run.
  351.          If you do not have enough memory then you will simply be returned
  352.          to the program.
  353.  
  354.          ALT-S : Toggle Snoop ON/OFF.  Some SYSOPs prefer not to watch what
  355.          a user is doing while in a door for whatever reasons.  Using this
  356.          function will clear the local screen and nothing will be written
  357.          to the local screen until ALT-S is pressed again, or until the
  358.          door is exited.  Note that the status bar will remain on unless it
  359.          has been toggled off.  This allows you to see who the user is, how
  360.          much time is left, etc.
  361.  
  362.          ALT-<UP ARROW>: Adds one minute to users time in the door (not
  363.          added to BBS time limit!)
  364.  
  365.          ALT-<DOWN ARROW>: Deducts one minute from the users time in the
  366.          door (not deducted from BBS time limit!)
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.          Page 6
  377.  
  378.  
  379.  
  380.         KINGDOM Sysop Documentation                           Ben Vegiard
  381.  
  382.  
  383.                                 ╔═══════════════╗
  384.                              ▓░▒║  OTHER NOTES  ║▒░▓
  385.                                 ╚═══════════════╝
  386.  
  387.          - A FILE NOT FOUND error message will appear when viewing a top
  388.            rankings file before anyone plays.  Kingdom doesn't create the
  389.            bulletin until someone plays a game.  It is attempting to
  390.            display the bulletin that hasn't been created yet.
  391.          - INSTRUCT.KNG and WIZARD.KNG may be edited, by a text editor, to
  392.            meet your needs.
  393.          - KINGDOM has three levels of play, easy, medium, and hard.  The
  394.            level setting is displayed to the user on the opening screen.
  395.            Easy simply means that it's not too hard to stay alive, but you
  396.            still need to work to make your kingdom better, Medium becomes a
  397.            struggle to keep afloat at first, and hard a almost impossible.
  398.            By placing a 0 in the config on this option you allow the player
  399.            the option of choosing their own level.  If players choose their
  400.            own level then their final score is adjusted by the level of
  401.            difficulty to reflect how well they played relative to other
  402.            levels.
  403.  
  404.  
  405.                               ╔═══════════════════╗
  406.                            ▓░▒║  HOW TO REGISTER  ║▒░▓
  407.                               ╚═══════════════════╝
  408.  
  409.          See the bottom of this section for what registration will get you.
  410.  
  411.          Registration is simple.  Fill out the inclosed ready to mail form,
  412.          pop in a check or money order made out to Ben Vegiard for $10.00
  413.          (U.S. Funds) and send it to the address written on the form.
  414.          Also, comments and questions are welcome at the same address.
  415.          Please support shareware so that programmers will continue to
  416.          produce quality software.
  417.  
  418.          If you have "lost" the form then send $10.00 (in U.S. Funds) to:
  419.  
  420.          Caliber Software
  421.          C/O Ben Vegiard
  422.          1406 Kingswood
  423.          Fulton, MO 65251
  424.  
  425.          Please include your BBS name (as it appears in your config file)
  426.          your BBS  phone  number(s),  your  address,  your  voice  phone
  427.          (optional) and where you got KINGDOM (friend, BBS, etc) If you are
  428.          FIDO compatible then please include your Net/Node number.
  429.  
  430.          WHAT YOU GET FOR REGISTERING: Registration will entitle you to the
  431.          latest version of KINGDOM (if you are not already using it), a
  432.          registration number for your config file that will work on all
  433.          updates and upgrades of this programs, and of course full credit
  434.          on the opening screen, and beside the castle during play.
  435.  
  436.  
  437.  
  438.  
  439.          Page 7
  440.  
  441.  
  442.  
  443.         KINGDOM Sysop Documentation                           Ben Vegiard
  444.  
  445.  
  446.                                ╔════════════════╗
  447.                             ▓░▒║  LEGAL NOTICE  ║▒░▓
  448.                                ╚════════════════╝
  449.  
  450.      This product is licensed "As is" without any warranty of
  451.      merchantability or fitness for a particular purpose, performance, or
  452.      otherwise.  All warranties are expressly disclaimed.  By using this
  453.      program you agree to that Ben Vegiard will not be liable to you or any
  454.      third party for any use, or inability to use, or performance of this
  455.      program for any damages whatsoever whether based on contract, tort, or
  456.      otherwise, even if I am notified of such possibility in advance.
  457.  
  458.      You may not reverse-engineer, disassemble, modify,  decompile or
  459.      create derivative works of this program.  Piracy has been investigate
  460.      by the FBI and prosecuted under federal statutes.  Applicable law
  461.      provides for damages and recovery of attorney's fees.  Distribution,
  462.      in any  medium,  without  its  accompanying  documentation  is  an
  463.      unauthorized modification.  That is a theft of intellectual property.
  464.  
  465.  
  466.                               ╔══════════════════╗
  467.                            ▓░▒║  SPECIAL THANKS  ║▒░▓
  468.                               ╚══════════════════╝
  469.  
  470.      I would like to thank Larry Burton of the IDEATE BBS for his help in
  471.      Beta testing KINGDOM, and for the solid ANSI suggestions.  I would
  472.      also like to give him credit for the ANSI graphic of the castle
  473.      displayed during play.
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.          Page 8
  503.  
  504.  
  505.  
  506.         KINGDOM Sysop Documentation                           Ben Vegiard
  507.  
  508.  
  509.                               ╔═══════════════════╗
  510.                            ▓░▒║  RELEASE HISTORY  ║▒░▓
  511.                               ╚═══════════════════╝
  512.  
  513.           - 01/15/92 Beta Release.
  514.  
  515.           - 03/28/92 Version 1.0:
  516.             Fixed  : 2 of the disasters did not subtract the penalties.
  517.             Fixed  : Local screen scrolled on 'Sleeping' disaster.
  518.             Fixed  : Redraw of screen workd properly after end of chat.
  519.             Changed: Some of the formulas on Easy and Hard levels to
  520.                      reflect more even scores.
  521.             Changed: (and enganced) Manu of the error messages.
  522.             Changed: Sysop and User Documentation.
  523.             Changed: Line 3 of the Config (Door drop file path) to help
  524.                      support multi-line operation better.
  525.             Added  : More natural disasters (including some GOOD ones...)
  526.             Added  : Improved command line support including the /L, /F,
  527.                      /NS, /NB, /H, and /? switches.
  528.             Added  : The Top Scores bulletin now adds in the dates when
  529.                      the scores where obtained.
  530.             Added  : Screen length support when reading instructions if
  531.                      using the DOOR.SYS door drop file.
  532.             Added  : The option to (S)top reading instructions in the
  533.                      middle of them.
  534.             Added  : Colors to the instruction screen and lightened the
  535.                      general color to accomodate monochrome users eyes.
  536.             Added  : Toggle snoop and status bar ALT keys and updated help
  537.                      line (ALT-F1) accordingly.
  538.             Added  : File locking for multi-node operations.
  539.             Added  : KING_UP.EXE file to the archive.
  540.             Added  : Wizard events on years 10, 20, 30, and 40 to make the
  541.                      game more 'interesting.'
  542.  
  543.           - 07/10/92 Version 1.1
  544.             Changed: Some of the spacings and colors, nothing major.
  545.             Changed: Software label name from Beeenware to Caliber.
  546.             Fixed  : ANSI bulletin now correctly show the propper dates.
  547.             Added  : New ANSI system which will hopefully speed the game
  548.                      displays up a bit.
  549.             Added  : Graphics toggle on main menu
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.          Page 9
  566.  
  567.  
  568.